home *** CD-ROM | disk | FTP | other *** search
/ LightWavin' Magazine 2 / LightWavin' Magazine, Issue 2 (LightWavin' Multimedia)(1997).iso / alpha / aplugins / spiral / spiral.txt < prev   
Text File  |  1996-05-29  |  4KB  |  102 lines
  1. Documentation for SpiralPath Plugin
  2. by 
  3. Prem Subrahmanyam (prems@noblestar.net)
  4.  
  5. Legal Stuff:
  6.  
  7. This plugin is distributed as freeware and is hence released into the
  8. public domain.  The author makes no warranty whatsoever regarding the
  9. fitness or usability of this product for any purpose and is not responsible
  10. for any damages whatsoever resulting from the use of this product.  In other
  11. words, use this product at your own risk.  
  12.  
  13. That said, here is a nifty little spiral path generator that I whipped up
  14. while learning the Lightwave plugin API.  It gives one the ability to create 
  15. helices, shell type spirals, etc. easily.  I am running Lightwave 5.0 on an
  16. Intel box under Win95, hence it will only work on another Intel box running
  17. Lightwave 4.0 or 5.0.  I assume it will run under Win3.11 as well as 95 or NT, 
  18. but I can't guarantee that).  
  19.  
  20. Installation:
  21. To install this plugin, simply copy it to your plugins\modeler directory, 
  22. run modeler, choose Object->Custom->Add Plugin and select the spiral.p 
  23. plugin file.  You should then see SpiralPath under your Object->Custom 
  24. requester.  
  25.  
  26. Running SpiralPath:
  27. When you invoke the SpiralPath plugin, you will see a requestor with the
  28. following fields:
  29.    
  30.    Axis: Select the X, Y, or Z axis as the central axis for the spiral
  31.  
  32.    Number of Segments: Select how many segments you would like in the spiral
  33.  
  34.    Degrees to rotate: Specify the number of degrees you want the spiral to 
  35.    rotate, with 360 completing one rotation.  For example, to make 3 
  36.    rotations, you would specify 1080 as the number of degrees.
  37.  
  38.    Length Delta Along Axis: Specify the length (in meters) that the spiral
  39.    will move along the spiral axis per segment.  By default this is zero;
  40.    this is useful in making helical spirals, off-axis shells, springs, 
  41.    curly cords, etc.
  42.  
  43.    Length Delta Scaling Factor: This factor is multiplied against the
  44.    length delta per segment.  It is useful for generating shells where
  45.    they grow in spacing per whorl.
  46.  
  47.    Starting Radius: Specify the starting radius in meters.
  48.  
  49.    Radius Delta Scaling Type: Specify whether the "Radius Delta per
  50.    Segment" is added to or multiplied against the radius.  Additive
  51.    causes the same radius delta to be added at each segment.  
  52.    Multiplicative will cause the factor to be multiplied against the
  53.    radius for each segment--essential for creating shell-type spirals.
  54.  
  55.    Radius Delta per Segment: See above.
  56.  
  57.  
  58. Tutorials:
  59.  
  60. #1: 
  61. Try the following Settings:
  62. Axis:                      Y
  63. Number of Segments:        20
  64. Degrees to Rotate:         1080
  65. Length Delta Along Axis:   0.5
  66. Axis Delta Scaling Factor: 1.0
  67. Starting Radius:           1.0
  68. Radius Delta Scaling Type: Additive
  69. Radius Delta per Segment:  0.0
  70.  
  71. Result: A helical coil path
  72.     
  73. #2: 
  74. Try the following settings:
  75. Axis:                      Y
  76. Number of Segments:        20
  77. Degrees to Rotate:         720
  78. Length Delta Along Axis:   0
  79. Axis Delta Scaling Factor: 1.0
  80. Starting Radius:           1.0
  81. Radius Delta Scaling Type: Multiplicative
  82. Radius Delta per Segment:  1.1
  83.  
  84. Result: a spiral similar to a nautiloid-type shell
  85.  
  86. #3: 
  87. Use the same coil as in Tutorial #2
  88. Copy and Paste this coil into another layer
  89. Scale the second coil by 0.5 around 0,0,0
  90. Create a ball in a third layer with the following parameters:
  91.    Globe
  92.    Sides:16
  93.    Segments:8
  94.    Center: 0 m, 8.6342 mm, 704.1709 mm
  95.    Radii: 0 m, 378.9174 mm, 794.0142 mm
  96. Now, with the other two coils selected in the background, perform
  97. a rail extrude with the default parameters.
  98.  
  99. Result: A nice nautilus shell.
  100.  
  101.  
  102.